# Практика Avi
## Про `selectStatement` и `onRefreshExt`
Изначально результат выборки формируется операцией `onRefresh` или `onRefreshItem` одним из двух способов: реляционный или объектный запрос.
### Реляционный запрос
В этом случае в теле `onRefresh` вызывается метод `selectStatement` или `prepareSelectStatement` (вызывает тот же `selectStatement`, но с добавлением фильтров, описанных в `avm`).
Иначе говоря, результатом операции `onRefresh` является текстовое значение, внутри которого реляционный запрос.
```{note}
onRefreshExt в случае формирования выборки реляционным запросом не вызывается!
```
Так формируется по умолчанию отображение `List` (кроме коллекций).
Не учитываются значения хранящиеся в кэше, учитываются значения только из БД.
Пример `selectStatement` для отображения `List`:
```scala
override protected def selectStatement: String = {
s"""SELECT
t.id
,t.idClass
,t.idState
,t1.sHeadLine_dz as idStateHL
,t.idStateMC
,t.idObjectType
,t2.sHeadLine_dz as idObjectTypeHL
,t.idDepOwner
,t3.sHeadLine_dz as idDepOwnerHL
,t.gidSrc
,t.idResourceHolder
,t4.sHeadLine_dz as idResourceHolderHL
,t.sRegNum
,t.dReg
,t.idPeriod
,t5.sHeadLine_dz as idPeriodHL
,t.sDescription
,t.gid
,t.sRegNum_dz
,t.sRegNumBMs_dz
,t.sRegNumidVer_dz
FROM Oil_DemandMov t
LEFT JOIN Btk_ClassState t1 on t.idState = t1.id
LEFT JOIN Btk_ObjectType t2 on t.idObjectType = t2.id
LEFT JOIN Bs_DepOwner t3 on t.idDepOwner = t3.id
LEFT JOIN Bs_Contras t4 on t.idResourceHolder = t4.id
LEFT JOIN Bs_Period t5 on t.idPeriod = t5.id
"""
}
```
### Коммит в БД при выполнении реляционного запроса и @FlushBefore
Важно понимать, что при реляционном запросе сервер приложения делает коммит в БД (особенность работы сервера приложения). Поэтому на выборках, где вводятся значения в поля и поддерживается возможность пользователю отменить изменения, нельзя использовать формирование выборки на реляционном запросе. Иначе данные запишутся в БД без разрешения пользователя (без нажатия пользователем на операцию сохранения (дискетка)).
Однако, иногда есть необходимость в выполнении выборки на реляционном запросе в отображении с редактированием полей. Например, выборка выпадающего списка `Lookup`.
В таком случае перед `onRefresh` необходимо добавить аннотоцию `@FlushBefore(mode = FlushBeforeMode.Disabled)`:
```scala
trait Lookup extends Default with super.Lookup {
@FlushBefore(mode = FlushBeforeMode.Disabled)
override protected def onRefresh: Recs = {
s"""SELECT
t.id
,t.sHeadLine_dz as sHeadLine
,t.sMnemoCode_dz as sMnemoCode
,coalesce(t.sMnemoCode_dz, '') || ' ' || coalesce(t.sHeadLine_dz, '') as sMnemoCodeHeadLine
from AsfEqp_IntoOperExt t
order by upper(t.sHeadLine_dz)
"""
}
}
```
Иначе при открытии выпадающего списка данные будут записываться в БД.
## Объектный запрос
В этом случае onRefresh формируется из экземпляров объектов `SRop` (инструменты `refreshByParent`, `load`, `TxIndex`, `OQuery`) или `case class`’ов.
В этом случае учитываются значения, хранящиеся в кэше.
Примеры:
По умолчанию отображение `List` у коллекций формируется с помощью `refreshByParent`:
```scala
trait List_idPlanFactoryShip extends Default with super.List_Master {
override protected def onRefresh: Recs = {
Oil_PlanFactShipSegrGroupApi().refreshByParent(getIdMaster)
}
}
```
По умолчанию отображение `Card` у коллекций формируется с помощью `load`:
```scala
trait Card extends Default with super.Card {
override protected def onRefreshItem: Recs = {
Oil_PlanFactShipSegrGroupApi().load(getVar(getPKFieldName).asNLong)
}
}
```
### onRefreshExt
В случае объектного запроса сервер сам вызывает метод `onRefreshExt`, в который можно дописать получение нехранимых полей на синтаксисе `SQL`, НЕ учитывая значения из кэша:
```scala
override protected def onRefreshExt: String = {
s"""with t as ( select
:id as id
,:idPlanFactoryShip as idPlanFactoryShip
,:idSegregationGroup as idSegregationGroup
)
SELECT
t.id
,t1.sHeadLine_dz as idPlanFactoryShipHL
,t2.sHeadLine_dz as idSegregationGroupHL
,t2.sMnemoCode_dz as idSegregationGroupMC
FROM t
LEFT JOIN Oil_PlanFactoryShip t1 on t.idPlanFactoryShip = t1.id
LEFT JOIN Oil_SegregationGroup t2 on t.idSegregationGroup = t2.id
"""
}
```
```{note}
Также существует другой способ реализовать нехранимые поля (через case class AdditionalInfo), который будет описан дальше. Данный способ формирует значения с учётом кэша.
```
## Добавление нехранимых полей
Здесь будет рассмотрено 2 случая, как реализовать нехранимые поля в выборке, реализованные реляционным запросом и объектным.
Для формирования нехранимого поля нужно:
- получить поле в запросе под заданным псевдонимом
- описать поле в разметке `avm` под тем же псевдонимом
### Формировать реляционно или объектно
Если нехранимый атрибут вычисляется динамически от изменений на выборке, это значит, что работа идёт с значениями из кэша, т.е. с значениями, которые ещё не закоммичены в БД. Это означает, что нехранимое поле реализовывать нужно на объектном запросе.
Например: в карточке документа нужно посчитать сумму по всем записям в коллекции. Если поле суммы реализовать реляционно, то оно будет формироваться только из согласованных в БД значений. Это значит, для того чтобы учитывались новые записи в коллекции, их нужно закоммитить (сохранить) в БД.
Если же поле реализовать объектно, то в нём будут учитываться данные из кэша, т.е. те самые созданные новые записи в коллекции, которые ещё не закоммичены в БД.
### Нехранимые поля в реляционном запросе
```{note}
Не учитывает значения из кэша, которые не закоммичены в БД.
```
Чтобы добавить не хранимый атрибут реляционно, нужно иметь значение атрибута в выборке запроса `selectStatement`.
Примером может служить результат кодогенератора ссылочного поля для отображения `List`, где описывается получение значения хэдлайна в `Dvi` и описание атрибута в `dvm`.
Dvi:
```scala
override protected def selectStatement: String = {
s"""SELECT
t.id
,t.idClass
,t.idObjectType
,t1.sHeadLine_dz as idObjectTypeHL --нехранимое поле
,t.dReg
,t.sRegNum
,t.idState
,t2.sHeadLine_dz as idStateHL --нехранимое поле
FROM Rzd_Train t
LEFT JOIN Btk_ObjectType t1 on t.idObjectType = t1.id
LEFT JOIN Btk_ClassState t2 on t.idState = t2.id
"""
```
dvm:
```xml